home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / swapclr.zip / SWAPCLR.DOC < prev    next >
Encoding:
Text File  |  1992-05-13  |  5.0 KB  |  114 lines
  1.  
  2. SwapColor V.1.5
  3. (c) Jeffrey Smith
  4.  
  5. What is SwapColor?
  6.  
  7.         SwapColor is a utility that reads a display file, such as
  8. Hello1.BBS and changes the existing @ color codes to new @ codes.
  9. There are several utils available that do this, however, you have
  10. to manually enter the codes to change if from, and then manually 
  11. enter the codes to change it to.   This works well if you are 
  12. there when the display file is created.  I like to be able to 
  13. change colors in display files to match the "color scheme" of my 
  14. BBS.  NETBULL, written by Michael Conley of the Charlatan's Cabin 
  15. BBS, creates a nice display file that I like to display to users
  16. as they are logging onto my BBS.  This file is created every morning
  17. at about 5:30 and I'm not "usually" around to go in and change
  18. the display file colors.  The RED and GREEN that this file
  19. creates doesn't match the Blues/Whites/Yellows that I use throughout
  20. my BBS, hence SwapColor can read the CFG file and swap the colors I
  21. want in the display file with the ones I don't want.  
  22.  
  23.         I wrote this program for myself, and was encouraged to 
  24. introduce it as shareware by several other SysOp friends of mine
  25. as they assured me other SysOps would like the ability to swap 
  26. colors around also.  This is, shall we say, a tentative step into
  27. the realm of shareware, if this is usefull, and people see fit to
  28. register it, I'll release some of the other utilities that I've 
  29. written as well.  
  30.  
  31. REGISTRATION
  32.  
  33.         The unregistered version of SwapColor will only execute 30
  34. times before you have to register it or discontinue use.  Until that
  35. time it has no delays, and does not require a key to operate.  If it
  36. takes you two years to run it 30 times, then you have two years to 
  37. evaluate it.  Any more than 30 executes and you either need to 
  38. register the program or discontinue its use.
  39.  
  40.         To register this program, you'll have to scrounge around 
  41. and come up with 5.00 bucks..  As running a board is not the least 
  42. expensive way to spend your time, and this is not the most complicated
  43. piece of code that has ever seen a compiler, I'm not asking for any 
  44. more than that. Now, if you have to urge to send more, well, "More power
  45. to ya!"  
  46.  
  47.         Fill out the registration form that is included in this 
  48. Archive and send it along with your check for 5.00 to 
  49.  
  50.                         Jeffrey Smith
  51.                         G3365 Swartz St.
  52.                         Flint, Mi 48507
  53.  
  54. Your registered copy of SwapColor will be available for download from
  55. my BBS the day that I recieve your registration.  Log onto the BBS as
  56. you normally would but you don't have to worry about callback or manual
  57. validation, as new users have access to the file area containing 
  58. the registered programs.  Look for the SWAP(n).ZIP file that has your
  59. name in the description, it will be password protected with the password 
  60. you included on your registration form.
  61.  
  62. My BBS info is -
  63.  
  64.                         Diamond Club!
  65.                         313-787-0270
  66.                         M-F 24hrs
  67.                         USR Dual 14400 
  68.  
  69. If you have any questions concerning this utility, bug reports, so on and 
  70. so forth, er...uh....critics are welcome too!  Call up Diamond Club! and
  71. leave a comment to the sysop and I'll do my darndest to help you out...
  72.  
  73. INSTALLATION
  74.  
  75.         Installation is pretty straight forward, you can copy Swapclr.exe 
  76. Swapclr.dat into whatever directory you choose, I recommend your \WC30 
  77. directory if you're using WildCat! 3.x.  Swapclr.dat MUST reside in the
  78. same directory as the .EXE or it will not execute.  
  79.  
  80.         You execute the program by entering, either manually, or in a 
  81. batch file - 
  82.  
  83.         SWAPCLR SWAP.CFG
  84.  
  85. It will read ANY config file name that you care to use.  This way you can
  86. have multiple config files which allows you to swap different colors in
  87. different display files without having to have 100 copies of the EXE and DAT
  88. file everywhere.  SWAP.CFG is just a sample name, I use multiple SWAP1.CFG, 
  89. SWAP2.CFG, SWAP3.CFG.  You could also call it by entering -
  90.  
  91.         Swapclr c:\wc30\util\swap1.cfg
  92.  
  93. The contents of the CFG file are as follows -
  94.  
  95.         HELLO3.CFG
  96.         @0E@@0F@
  97.         @0A@@0B@
  98.  
  99. The first line is the name (and path if you want) of the display file to 
  100. change colors in.  You could also enter C:\WC30\DISP\HELLO3.CFG if you like.
  101. I keep the executables and the swap(n).CFG files in a util directory and
  102. enter the path the the display file in the CFG file.  Whatever you want
  103. to do will work.  The next 1-10 lines are the orig. color codes and the 
  104. new color codes.  You can have between 1 and 10 color code swaps in one
  105. CFG file.  They must be entered as above with no spaces between the orig.
  106. color code and the new color code.  Each pair of codes must be on a 
  107. seperate line. There is no need for blank lines if you are not doing
  108. 10 swaps, only as many lines as you need.
  109.  
  110. Hope you enjoy this utility and I also hope it enhances your BBS in some
  111. way.  
  112.  
  113.  
  114.